Node / meshtastic / Meshtastic-Android / files / core / konsist / README.md

Displaying Rendered • View raw • Download

The T383838:core:konsist module is the architecture-guard module. It holds no production code — only Konsist tests that scan every module's Kotlin source from disk and assert the repo's KMP boundary rules from T383838AGENTS.md.

Konsist is JVM-only, so the tests live in T383838jvmTest (they cannot go in T383838commonTest).

T383838CommonMainFrameworkBoundaryTest enforces the framework-bleed rule for shared code — any file in a T383838commonMain source set must never depend on platform APIs:

• no T383838android.* imports in T383838commonMain

• no T383838java.* imports in T383838commonMain

Shared code must use the KMP equivalents instead (Okio, kotlinx-datetime, atomicfu, T383838Mutex, …). Because Konsist scans the whole project from disk (T383838Konsist.scopeFromProject()), this single test class covers every module in the repo.

T282828

The tests execute on the JVM target only. They run in CI as part of the standard T383838allTests baseline gate, so a framework-bleed regression anywhere in the repo fails this module's tests.